home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / p_man / cato / Xm / XmStringByteCompare.z / XmStringByteCompare
Encoding:
Text File  |  1998-10-20  |  4.0 KB  |  67 lines
  1.  
  2.  
  3.  
  4.      XXXXmmmmSSSSttttrrrriiiinnnnggggBBBByyyytttteeeeCCCCoooommmmppppaaaarrrreeee((((3333XXXX))))   UUUUNNNNIIIIXXXX SSSSyyyysssstttteeeemmmm VVVV   XXXXmmmmSSSSttttrrrriiiinnnnggggBBBByyyytttteeeeCCCCoooommmmppppaaaarrrreeee((((3333XXXX))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XXXXmmmmSSSSttttrrrriiiinnnnggggBBBByyyytttteeeeCCCCoooommmmppppaaaarrrreeee - A compound string function that
  10.           indicates the results of a byte-by-byte comparison
  11.  
  12.      SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.           ####iiiinnnncccclllluuuuddddeeee <<<<XXXXmmmm////XXXXmmmm....hhhh>>>>
  14.  
  15.           BBBBoooooooolllleeeeaaaannnn XXXXmmmmSSSSttttrrrriiiinnnnggggBBBByyyytttteeeeCCCCoooommmmppppaaaarrrreeee ((((_s_1, _s_2))))
  16.                XXXXmmmmSSSSttttrrrriiiinnnngggg  _s_1;;;;
  17.                XXXXmmmmSSSSttttrrrriiiinnnngggg  _s_2;;;;
  18.  
  19.  
  20.      VVVVEEEERRRRSSSSIIIIOOOONNNN
  21.           This page documents version 1.2 of the Motif library.
  22.  
  23.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  24.           XXXXmmmmSSSSttttrrrriiiinnnnggggBBBByyyytttteeeeCCCCoooommmmppppaaaarrrreeee returns a Boolean indicating the results
  25.           of a byte-by-byte comparison of two compound strings.
  26.  
  27.           In general, if two compound strings are created with the
  28.           same (char *) string using XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeeeLLLLooooccccaaaalllliiiizzzzeeeedddd in the
  29.           same language environment, the compound strings compare as
  30.           equal.  If two compound strings are created with the same
  31.           (char *) string and the same font list element tag set other
  32.           than XXXXmmmmFFFFOOOONNNNTTTTLLLLIIIISSSSTTTT____DDDDEEEEFFFFAAAAUUUULLLLTTTT____TTTTAAAAGGGG using XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeee, the
  33.           strings compare as equal.
  34.  
  35.           In some cases, once a compound string is put into a widget,
  36.           that string is converted into an internal form to allow
  37.           faster processing.  Part of the conversion process strips
  38.           out unnecessary or redundant information.  If an application
  39.           then does an XXXXttttGGGGeeeettttVVVVaaaalllluuuueeeessss to retrieve a compound string from
  40.           a widget (specifically, Label and all of its subclasses), it
  41.           is not guaranteed that the compound string returned is
  42.           byte-for-byte the same as the string given to the widget
  43.           originally.
  44.  
  45.  
  46.           _s_1     Specifies a compound string to be compared with _s_2
  47.  
  48.           _s_2     Specifies a compound string to be compared with _s_1
  49.  
  50.  
  51.      RRRREEEETTTTUUUURRRRNNNN VVVVAAAALLLLUUUUEEEE
  52.           Returns True if two compound strings are identical byte-by-
  53.           byte.
  54.  
  55.      RRRREEEELLLLAAAATTTTEEEEDDDD IIIINNNNFFFFOOOORRRRMMMMAAAATTTTIIIIOOOONNNN
  56.           XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeee((((3333XXXX)))) and XXXXmmmmSSSSttttrrrriiiinnnnggggCCCCrrrreeeeaaaatttteeeeLLLLooooccccaaaalllliiiizzzzeeeedddd((((3333XXXX)))).
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 4/30/98)
  64.  
  65.  
  66.  
  67.